docs: Adds quickstart doc for flutter windows SDK#1231
Open
NandanPrabhu wants to merge 2 commits into
Open
Conversation
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Summary
Errors per inputErrors in main/docs/quickstart/native/flutter-windows/index.mdx
|
… web and windows details. Instead it will point to flutter web and fluter windows for web and windows respectively
86b8d88 to
437ff02
Compare
avanscoy
reviewed
May 22, 2026
| This feature is in **beta** (`auth0_flutter` 2.1.0-beta.1). The API may change before general availability. | ||
| </Note> | ||
|
|
||
| This guide walks you through adding login, logout, and user profile display to a Flutter Windows desktop app using the `auth0_flutter` SDK with OAuth 2.0 Authorization Code Flow + PKCE. |
Contributor
There was a problem hiding this comment.
Suggested change
| This guide walks you through adding login, logout, and user profile display to a Flutter Windows desktop app using the `auth0_flutter` SDK with OAuth 2.0 Authorization Code Flow + PKCE. | |
| This guide walks you through adding login, logout, and user profile display to a Flutter Windows desktop app using the `auth0_flutter` SDK with OAuth 2.0 [Authorization Code Flow + PKCE](/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce). |
avanscoy
reviewed
May 22, 2026
| </Tab> | ||
|
|
||
| <Tab title="Dashboard"> | ||
| 1. Go to [Auth0 Dashboard](https://manage.auth0.com/) → **Applications > Applications** |
Contributor
There was a problem hiding this comment.
Please add ending punctuation to the steps.
avanscoy
reviewed
May 22, 2026
|
|
||
| **Expected flow:** | ||
|
|
||
| 1. App launches with a **Log In** button |
Contributor
There was a problem hiding this comment.
Add ending punctuation to the steps
| **Expected flow:** | ||
|
|
||
| 1. App launches with a **Log In** button | ||
| 2. Click **Log In** → your system browser opens the Auth0 Universal Login page |
Contributor
There was a problem hiding this comment.
Suggested change
| 2. Click **Log In** → your system browser opens the Auth0 Universal Login page | |
| 2. Select **Log In**. Your system browser opens the Auth0 Universal Login page. |
|
|
||
| --- | ||
|
|
||
| ## Troubleshooting & Advanced Usage |
Contributor
There was a problem hiding this comment.
Suggested change
| ## Troubleshooting & Advanced Usage | |
| ## Troubleshoot & Advanced Use |
| **Symptom**: Auth0 login succeeds in browser but the app never receives the credentials. | ||
|
|
||
| **Fix:** | ||
| 1. Open Registry Editor → `HKEY_CURRENT_USER\Software\Classes\auth0flutter\shell\open\command` and confirm the path to your `.exe` |
| **Symptom**: Login appears to hang and eventually fails. | ||
|
|
||
| **Fix:** The app never received the callback URI. Verify: | ||
| 1. The registry entry points to the correct executable path |
| **Symptom**: A new window opens instead of the existing app receiving the callback. | ||
|
|
||
| **Fix:** | ||
| 1. Kill all running instances in Task Manager |
| **Fix:** | ||
| 1. Kill all running instances in Task Manager | ||
| 2. Ensure the mutex name is consistent in `main.cpp` | ||
| 3. Rebuild: `flutter clean && flutter run -d windows` |
Contributor
There was a problem hiding this comment.
Suggested change
| 3. Rebuild: `flutter clean && flutter run -d windows` | |
| 3. Rebuild with the following command: `flutter clean && flutter run -d windows`. |
|
|
||
| **Symptom**: Error "redirect_uri_mismatch" from Auth0. | ||
|
|
||
| **Fix:** |
Contributor
There was a problem hiding this comment.
Ending punctuation for these steps
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR adds quickstart doc for auth0-flutter windows SDK. It also updates flutter quickstart to not contain details for web and windows platform but instead point to the respective flutter web and windows quickstart docs.
References
Testing
Tested it by building locally using mint dev commands
Checklist
CONTRIBUTING.md.